home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / c / cvesa.zip / VIDLIB.DOC < prev    next >
Text File  |  1992-01-06  |  6KB  |  113 lines
  1. -------------------------------------------------------------------------
  2.         DBVGAL15.ZIP            David Boynton's VGA Library, V1.5
  3. -------------------------------------------------------------------------
  4.         This library is placed in the public domain. However, if you like
  5.         it, and would like to make a small donation to encourage me to 
  6.         improve this product, my address is:
  7.                 David Boynton
  8.                 8083 Budding Br Rd, T-3
  9.                 Glen Burnie  MD 21061-5077
  10.          Please let me know of any "corrections" or improvements you'd
  11.          like to see.
  12.  
  13.          Send netmail to either: Avi-technic BBS 1:261/662
  14.                              or: Dave's Doghouse 1:261/1096 (different Dave)
  15.  
  16.          Detailed instructions can be obtained from the header files.
  17.  
  18. -------------------------------------------------------------------------
  19.          VIDLIB.H
  20. -------------------------------------------------------------------------
  21.          The library is built from seven major components:
  22.  
  23.          masm functions  
  24.          vidlib.obj     general VGA functions
  25.          vidlib4.obj    16 color mode VGA functions 
  26.          vidlib8.obj    256 color mode VGA functions
  27.          vesa.obj       general VESA functions
  28.          vesa8.obj      256 color mode (640x400,640x480,etc) VESA functions
  29.          vtext.obj      text mode function (25,28,33,40,50 line mode sets)
  30.  
  31.          Caveat Programmer: remember, all function arguments are in bytes,
  32.                 not pixels; there is no bitblt (unaligned move) function
  33.                 in this library for 16 color modes. 
  34.                 Also, beware of using the low-level VGA register functions
  35.                 with inappropriate values. They do no checking for ignorance.
  36.  
  37.          Most of the C functions would be a lot faster in masm, but I haven't
  38.          gotten around to converting them yet. The 16 color functions in
  39.          particular.
  40. -------------------------------------------------------------------------
  41.          DEMOS
  42. -------------------------------------------------------------------------
  43.          They were never really intended as "Demos" in the way you probably
  44.          think, but as "test" programs to show how the library works (or IF
  45.          the library works). 
  46.  
  47.          testvl.exe:    tests the text, 16 color, 256 color, 256 color vesa, 
  48.                         and palette functions. 
  49.          test.exe:      tests the low-level (VGA register level) functions.
  50.          vgaregs.exe:   uses the library to dump the VGA registers to the
  51.                         standard output. 
  52.          vesainfo.exe:  shows information about what VESA modes are available
  53.                         on the current display card.
  54.          l28.com:       sets the display to 28 lines, EGA font (9x14).
  55.          l33.exe:       33 lines, modified EGA font (9x12).
  56.          l40.com:       40 lines, CGA font in larger box (9x10). Note that 
  57.                         line-drawing characters don't connect in this mode.
  58.  
  59. -------------------------------------------------------------------------
  60.          DEBUGGING
  61. -------------------------------------------------------------------------
  62.          The library currently has a "debugging mode" built in. All you 
  63.          have to do is call the 'Start_vgadebug(pathname)' to open (or append)
  64.          a debug file, and 'Close_vgadebug()' to turn it off. It can
  65.          be turned on/off/on/ etc. several times during a given program.
  66.  
  67. -------------------------------------------------------------------------
  68.          VESA.H
  69. -------------------------------------------------------------------------
  70.          The functions in this module have undergone a lot of work and 
  71.          testing. If all you need is 256 color modes, this has everything
  72.          you need. Run testvl.exe (after loading your vesa BIOS driver) for
  73.          a sample.
  74.  
  75. -------------------------------------------------------------------------
  76.          Credits
  77. -------------------------------------------------------------------------
  78.          Much credit goes to books like:
  79.  
  80.          "Advanced Programmer's Guide to SuperVGAs", George Sutty and
  81.          Steve Blair. Published by Brady; ISBN 0-13-010455-8.
  82.  
  83.          "Power Graphics Programming", Michael Abrash. Published by Que;
  84.          ISBN 0-88022-500-9.
  85.  
  86.          No part of this library comes directly out of either book; all
  87.          is original programming.
  88.          The vesainfo.c demo program mostly came from the first book; 
  89.          I rewrote it to take advantage of my library.
  90.  
  91. -------------------------------------------------------------------------
  92.          Coming Soon
  93. -------------------------------------------------------------------------
  94.          vtext          - will support the full 256k (or 512k) VGA buffer.
  95.                           (for storage of text screens, or anything else)
  96.  
  97.          vidlib4        - will have a bitblt. 
  98.                         - line and curve drawing.
  99.  
  100.          vidlib8        - Anti-aliasing, palette manipulation, full use of
  101.                           VGA memory.
  102.  
  103.          vidlib         - non-standard mode sets like 320x240, 320x400, 
  104.                           and functions to support them (the hard part).
  105.                           I already have the code for the mode sets, but
  106.                           it's what you do after that's so complicated.
  107.  
  108.          vesa4          - ?
  109.  
  110.          vesa8          - support for independent read/write windows.
  111. -------------------------------------------------------------------------
  112.  
  113.